home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / f90 / ishell.z / ishell
Text File  |  1998-10-30  |  3KB  |  58 lines
  1. ISHELL(3F)                                             Last changed: 1-6-98
  2.  
  3.  
  4. NNAAMMEE
  5.      IISSHHEELLLL - Executes a UNICOS shell command
  6.  
  7. SSYYNNOOPPSSIISS
  8.      IISSTTAATT == IISSHHEELLLL((_c_o_m_m_a_n_d))
  9.  
  10. IIMMPPLLEEMMEENNTTAATTIIOONN
  11.      UNICOS, UNICOS/mk, and IRIX systems
  12.  
  13. DDEESSCCRRIIPPTTIIOONN
  14.      On IRIX systems, this routine is in lliibbffffiioo..ssoo which is linked by
  15.      default when compiling programs with the MIPSpro 7 Fortran 90 compiler
  16.      or when compiling programs with the --ccrraayylliibbss option to the MIPSpro
  17.      7.2 F77 compiler.
  18.  
  19.      IISSHHEELLLL executes a UNICOS shell command.  IISSHHEELLLL has the following
  20.      argument:
  21.  
  22.      _c_o_m_m_a_n_d   Command to be given to the shell; can be of type character
  23.                or some numeric type.  If it is a noncharacter type, the
  24.                command should consist of packed characters terminated by a
  25.                null byte.
  26.  
  27.                On IRIX systems, this argument must be of type character.
  28.  
  29.      IISSHHEELLLL passes _c_o_m_m_a_n_d to the shell sshh(1) as input, as if _c_o_m_m_a_n_d were
  30.      entered at a terminal.
  31.  
  32. RREETTUURRNN VVAALLUUEESS
  33.      IISSHHEELLLL returns the termination status filled in by the wwaaiittppiidd(2)
  34.      system call, which is used to wait for the child shell process.
  35.      Unless the command was interrupted by a signal, its exit status is
  36.      contained in bits 8 through 15 (bit 0 being the least significant bit)
  37.      of the value returned by IISSHHEELLLL (see the wwaaiittppiidd(2) man page for more
  38.      information).  However, if any errors occur in running the shell or
  39.      collecting its exit status, IISSHHEELLLL returns a negative number; this
  40.      number is the negative value of eerrrrnnoo corresponding to the error.
  41.  
  42. EEXXAAMMPPLLEESS
  43.                 WRITE(TPMNT,500) DTV, XDT, VOL, XVOL, DSN, PDN, MBSV
  44.                 CALL ISHELL(TPMNT)
  45.            500  FORMAT('tpmnt -l sl -F U -T -g ',a6,' -x ',a6,
  46.                +       '-v ',a6,'=',a6,' -P ',a8,' -f ',a, ' -b ',a)
  47.  
  48. SSEEEE AALLSSOO
  49.      ppsshheellll(1) in the _U_N_I_C_O_S _U_s_e_r _C_o_m_m_a_n_d_s _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l, publication SR
  50.      -2011
  51.  
  52.      ssyysstteemm(3C) in the _U_N_I_C_O_S _S_y_s_t_e_m _L_i_b_r_a_r_i_e_s _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l,
  53.      publication SR-2080
  54.  
  55.      _A_p_p_l_i_c_a_t_i_o_n _P_r_o_g_r_a_m_m_e_r'_s _L_i_b_r_a_r_y _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l, publication SR-
  56.      2165, for the printed version of this man page.
  57.  
  58.